package com.celeste.mcpserverfeishu.service;

import com.celeste.mcpserverfeishu.dto.block.CreateBlockResponse;
import com.celeste.mcpserverfeishu.dto.document.CreateDocumentResponse;

/**
 * 飞书服务接口
 */
public interface FeishuService {
    
    /**
     * 创建文档
     *
     * @param accessToken 访问令牌
     * @param title 文档标题
     * @param folderToken 文件夹令牌，可为空
     * @return 创建的文档信息
     */
    CreateDocumentResponse.Document createDocument(String accessToken, String title, String folderToken);
    
    /**
     * 获取文档内容
     *
     * @param accessToken 访问令牌
     * @param documentId 文档ID
     * @return 文档内容
     */
    String getDocumentContent(String accessToken, String documentId);
    
    /**
     * 在文档中创建文本块
     *
     * @param accessToken 访问令牌
     * @param documentId 文档ID
     * @param content 文本内容
     * @return 创建的块信息
     */
    CreateBlockResponse.Block addTextToDocument(String accessToken, String documentId, String content);
} 